All DatabasesInside Mac - AppleEvents
AEPutArray
AEPutArray Put Apple Event data into a descriptor list
#include <AppleEvents.h> Apple Event Manager
OSErr AEPutArray ( theAEDescList, arrayType, arrayPtr, itemType,
itemSize, itemCount );
AEDescList * theAEDescList descriptor list to which descriptor record
added
AEArrayType arrayType ; type of array (see below)
AEArrayDataPointer arrayPtr ; pointer to buffer containing the array
DescType itemType ; descriptor type of items to be created
Size itemSize ; size of item
long itemCount ; count of number of items
returns Error Code; 0 = no error
The AEPutArray function puts the data for an Apple event array into a
descriptor list.
The parameter theAEDescList is the descriptor list into which to put the Apple
event array. If there are any items already in the descriptor list, they are
replaced.
The arrayType parameter is the Apple event array type to be created. This is
specified by one of the following constants: kAEDataArray, kAEPackedArray,
kAEHandleArray, kAEDescArray, or kAEKeyDescArray. The kAEDataArray
constant refers to an array of integers; kAEPackedArray refers to an array of
characters; kAEHandleArray refers to an array of handles; kAEDescArray
refers to an array of descriptor records; and kAEKeyDescArray refers to an
array of keyword-specified descriptor records.
If you are putting an array into a factored descriptor list, the data for each
array element must include the data that is common to all the descriptor
records in the list. The Apple Event Manager automatically isolates the data
you specified in the call to AECreateList that is common to all the elements of
the array.
The arrayPtr parameter is a pointer to the buffer containing the array.
For packed, data, and handle arrays, the itemType parameter specifies the
descriptor type of array items to be created.
For packed and data arrays, the itemSize parameter specifies the size, in
bytes, of the array items to be created.
The itemCount parameter is the number of elements in the array.
Result codes
noErr (0) No error
memFullErr (-108) Not enough room in heap zone
errAEWrongDataType (-1703) Wrong descriptor type
errAENotAEDesc (-1704) Not a valid descriptor record
Referenced by (3):